---
title: KeyBinds 快捷键绑定
icon: Keyboard
relatedFile: app/src/core/service/controlService/shortcutKeysEngine/KeyBinds.tsx
---

这个服务用于管理应用程序中的快捷键绑定。它允许用户自定义和持久化键盘快捷键，并提供机制来监听这些快捷键的触发。

### 持久化管理

服务通过内部存储机制来保存和加载用户的快捷键设置，确保设置在应用重启后依然有效。

### API 方法

#### `set(id: string, key: string)`

设置指定 `id` 的快捷键绑定为 `key`。

#### `get(id: string)`

获取指定 `id` 的快捷键绑定。

#### `watch(key: string, callback: (value: string) => void)`

监听某个快捷键的变化，当其值被更新时触发回调函数。

#### `entries()`

获取所有已存储的快捷键绑定。

#### `create(id: string, defaultKey: string, onPress: () => void)`

注册一个新的快捷键绑定。如果用户未设置，则使用 `defaultKey` 作为默认值。当快捷键被触发时，执行 `onPress` 回调。
